home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / system / mdosp401.zip / README < prev    next >
Text File  |  1991-10-27  |  18KB  |  475 lines
  1. ---------------------------------------------
  2. * MultiDos Plus Rel. 4.01 Shareware Version *
  3. * Copyright (c) 1986 - 1991  Nanosoft Inc.  *
  4. ---------------------------------------------
  5.  
  6. Welcome to MultiDos Plus, a powerful real-time multitasking shell
  7. for DOS.  MultiDos Plus is a copyrighted work of Nanosoft Inc
  8. and is NOT public domain.
  9.  
  10. If you like this product, register with us for $35, and we will
  11. send you the commercial version of MultiDos Plus ($99 value)
  12. with printed documentation.
  13.  
  14. You may freely copy and distribute this product as long as you
  15. abide by the following conditions:
  16.  
  17.     a) You may not charge any fee for making copies or sell this product.
  18.     b) You may not distribute this as part of any product or
  19.        service for which you charge a fee.
  20.     c) You must copy the product in its entirety with no changes.
  21.  
  22. If you would like to do any of the above, you must have our permission
  23. in writing.  Contact us for site licensing and royalty arrangements.
  24.  
  25. ------------
  26. * WARRANTY *
  27. ------------
  28.  
  29. This product is distributed with absolutely no warranty of
  30. any kind.
  31.  
  32. -------------------
  33. * How to Register *
  34. -------------------
  35.  
  36. Send a check for $35 to:
  37.  
  38.      Nanosoft Inc.
  39.      13 Westfield Road
  40.      Natick, MA 01760
  41.      Attn: Shareware Dept.
  42.  
  43. To register using Mastercard or Visa call (508) 651-0091.
  44.  
  45. To register by FAX send name, address, and charge card information
  46. (be sure to include expiration date) and telephone numbers
  47. to (508) 655-8860.
  48.  
  49. -------------------------------------------------------------
  50. * Differences between the commercial and shareware versions *
  51. -------------------------------------------------------------
  52.  
  53. The commercial version which you will receive when you
  54. register has the following additional features:
  55.  
  56.    a) It supports 64 tasks instead of the 3 tasks supported
  57.    by this version.
  58.  
  59.    b) The commercial version supports programs running in
  60.    LIM 4.0 expanded memory.  This version supports progams
  61.    running in conventional memory only.
  62.  
  63. The documentation accompanying this product is for the
  64. commercial version.  Therefore, disregard all references
  65. to expanded memory and related commands.
  66.  
  67. -----------------------------
  68. * To install MultiDos Plus: *
  69. -----------------------------
  70.  
  71. Print the file MDSHARE.PRN and read it before using
  72. Multidos Plus.
  73.  
  74. For a quick start type MULTIDOS to start the
  75. program.  When it is up, type a ? for a brief
  76. list of commands.  
  77.  
  78. The following is a list of new features or information
  79. not found in the manual.  Read the manual first before
  80. reading the following sections.
  81.  
  82. --------------------
  83. Command Line Options
  84. --------------------
  85.  
  86. A new command line option has been added which tells MultiDos Plus not
  87. to load the MDBIO10.EXE display BIOS.  This option may be invoked by
  88. typing /NO10 on the MultiDos Plus command line.  For example:
  89.  
  90.     MULTIDOS /NO10
  91.  
  92. This option is useful for applications which only have one task which
  93. will ever write to the display.  It may also be useful if your tasks
  94. cooperate with each other in their use of the display by using a
  95. resource semaphore to control display usage.
  96.  
  97. Please note that RS-232 output redirection is performed by the MDBIO10
  98. module.  If your application uses the COMM command to specify I/O
  99. redirection, the /NO10 option will disable the redirection of the
  100. display output.
  101.  
  102.  
  103. *** /NOMAP ***
  104.  
  105. A new option is available to disable the mapping of LIM memory into
  106. empty spaces above the C000 segment.  Use /NOMAP to disable the mapping.
  107.  
  108.  
  109. *** /NOCB ***
  110.  
  111. A new option is available to disable the checking for CTRL-C and
  112. CTRL-BREAK during DOS writes.  Use /NOCB to completely disable the
  113. checking for these two key combinations.  If this option is not used
  114. and a CTRL-C is pressed during a DOS write to the CRT display, the
  115. application may be aborted, or if if has an INT 23H handler that ignores
  116. CTRL-C or CTRL-BREAK, an ugly unexpected ^C may be displayed.
  117.  
  118. Using /NOCB makes it possible to use the ANSI.SYS functions to format
  119. and control a display without risking that the operator may enter a
  120. CTRL-C during a DOS display write.
  121.  
  122.  
  123. -----------------
  124. Operator Commands
  125. -----------------
  126.  
  127. * ASG Command *
  128.  
  129. MultiDos Plus has a feature which will enable certain keys
  130. to bring a task to the foreground immediately without using the
  131. ALT Z sequence.  The PC keyboard function keys and ALT keys may be
  132. used for this purpose.  For example, the F1 function key may be set to
  133. always bring the COMMAND task to the foreground.  Once a key assignment
  134. has been made, the task may be brought to the foreground any time the
  135. key is pressed.  The way to make this assignment is to use the ASG command.
  136.  
  137. The ASG command allows the assignment of up to 10 keys to 10 tasks.
  138. The syntax for the ASG command is:
  139.  
  140.    ASG [<task name> <index> <scan code>]
  141.  
  142. If the ASG command is entered without any arguments, a list of current
  143. key assignments will be displayed.  Each of the 10 entries in the
  144. assignment table is listed in the order: index, scan code, task name.
  145.  
  146. The arguments specify a mapping between a specified scan code and a
  147. task name.  The scan code must be specified as a decimal number.  The
  148. ASG command to map the COMMAND task to the F1 function key would be:
  149.  
  150.    ASG COMMAND 0 59
  151.  
  152. This command would set the first entry in the assignment table to
  153. map the task COMMAND to scan code 59 which is the F1 function key.
  154.  
  155. The decimal values for the function key scan codes are:
  156.  
  157.        Key    Normal Shifted   Ctrl     Alt
  158.  
  159.     F1    59    84    94    104
  160.     F2    60    85    95    105
  161.     F3    61    86    96    106
  162.     F4    62    87    97    107
  163.     F5    63    88    98    108
  164.     F6    64    89    99    109
  165.     F7    65    90    100    110
  166.     F8    66    91    101    111
  167.     F9    67    92    102    112
  168.     F10    68    93    103    113
  169.  
  170. The scan codes for other function keys and the Alt keys may also
  171. be used.
  172.  
  173. If an astrisk is used in the place of a task name, the key assignment
  174. has a different meaning.  Whenever that key is pressed, the previous
  175. foreground task is brought back to the foreground.  For example:
  176.  
  177.     ASG * 0 61
  178.  
  179. Whenever the F3 function key is pressed, the previous foreground task
  180. will be brought back to the foreground.
  181.  
  182. The value after the task name is the assignment table index and can
  183. range from 0 to 9.  Entries may be placed in any order in the table.
  184. When a key is pressed, the entry with a matching scan code closest
  185. to the begining of the table is used.
  186.  
  187. The /NALTZ command line option will not disable the single key task
  188. selection feature.
  189.  
  190.  
  191.  
  192. * BAT Command *
  193.  
  194. The BAT command will tell MultiDos Plus to execute commands from an
  195. ASCII text file as if they were entered from the keyboard.  The format
  196. is:
  197.  
  198.    BAT filename
  199.  
  200. where filename is any DOS pathname.  All commands in the file are executed
  201. by MultiDos Plus before any other commands (i.e. INT 15H, function 15)
  202. are executed.  No other task's child process requests are processed
  203. until the BAT command is finished.
  204.  
  205. A BAT batch file can also contain embeded batch commands.
  206.  
  207.  
  208.  
  209.  
  210. * FG Command *
  211.  
  212. A feature of the FG command, missing from the manual, is the ability
  213. to bring the previous foreground task back into the foreground without
  214. having to know the task's name.  If an astrisk is used in place of the
  215. task name, the previous foreground task is brought back to the foreground.
  216. This function is most useful when a task is done with the foreground and
  217. wants to switch itself to the background, restoring the task that was
  218. previously in the foreground.  The task can submit an FG command, using
  219. INT 15H function code 15, to MultiDos Plus.
  220.  
  221.  
  222.  
  223. * REM Command *
  224.  
  225. A command has been added to allow the addition of remark statements to
  226. automatic startup files.  The REM command may be added to document
  227. the content of the file.  Any characters after the REM are completly
  228. ignored.  The following are examples of some REM statements:
  229.  
  230.      REM  This is a test
  231.      REMthisisatest
  232.      REMARKABLE application written by Jack Spratt
  233.  
  234.  
  235. -----------------------------
  236. Application Program Interface
  237. -----------------------------
  238.  
  239. Several additional functions have been added to the Appl